docs: Allow influencing pandoc divisons

Arrange for files named section-foo.md to be turned
into docbook sections, while others get turned into
chapters. This is necessary to allow including such
content in chapters, since chapters in docbook don't
nest.

diff --git a/docs/reference/gtk/gtk-markdown-to-docbook b/docs/reference/gtk/gtk-markdown-to-docbook
index 247c613dceb8437974bc0e6c1e808f0f358c4d40..aa5dd53e6163cef643cfe27375bb74b05873e155 100755 (executable)
--- a/docs/reference/gtk/gtk-markdown-to-docbook
+++ b/docs/reference/gtk/gtk-markdown-to-docbook
@@ -167,12 +167,16 @@ MarkdownExtensions = {
 
 def ConvertToDocbook(infile, outfile):
     basename = os.path.basename(infile)
+    if basename.startswith('section'):
+        division='section'
+    else:
+        division='chapter'
     input_format = "markdown" + "".join(MarkdownExtensions)
     output_format = "docbook"
     subprocess.check_call(["pandoc", infile, "-o", outfile,
                            "--from=" + input_format,
                            "--to=" + output_format,
-                           "--top-level-division=chapter"])
+                           "--top-level-division=" + division])
 
 def ExpandGtkDocAbbreviations(infile, outfile):
     contents = open(infile, 'r', encoding='utf-8').read()